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public class ModuleDetails implements Serializable 
{ 

/** Modules port number */ 
int PortNumber; 

/** Modules name V 
String ModuleName; 

/** Modules IP address */ 
String IPAddress; 

/** Modules State of Health */ 
String SOH; 

} 
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public void Searching(String temp) 
{ 

if (temp.equalslgnoreCase("SHTR JAM")) 
{ 

Log[0] = Log[0] +1 ; // Incrementing the log if a match is found 
if (Log[0] >= 0) // Threshold = 0 

error.setErrorArray(0,"Shutter Jam"); // If the threshold is broken 

then 

//set array locationO to 
'Shutter Jam' 

} 

// Calls the function that will send the Error Array to the Regional 
// Server and generate and Alert Agent if the error is fatal 
send(); 
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/** Determines whether or not to send out a Alert Agent */ 
public void processReturningAgent() 
{ 

int count =0; 

Vector ATMsToVisit = new Vector(1 ,1); 
AlertAgent aAgent; 

ATMsToVisit = mAgent.getATM(); 
int size = ATMsToVisit. size(); 

while (count < size) // Extracts the records one at a time and examines the State of Health 
{ 

ModuleDetails Mtemp = (ModuleDetails)ATMsToVisit.elementAt(count); 
String tempSOH = Mtemp.getSOH(); // Gets the modules state of Health 

if (tempSOH.equals("Healthy n )) 
{ 
} 

else 

// Create an alert agent and initialise it with the Replenisher Location Details. 
{ 

agent = new AlertAgent(ReplP, RepPort,Mtemp); 

// Get the Internet address and the port number 

// of the first Replenisher String nextAddress = ReplP[0]; 

int nextPort = RepPort[0]; 

// Send out the Alert Agent 

MonitorClient client = new MonitorClient(nextAddress,nextPort,aAgent); 
} 

count++; 
} 

} 
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public void StoreData() 
{ 

int count =0; 
boolean flag = false; 

String temp = sAgent.getReplenisherslP(); 

while(ReplP[count] != null) // Finds the next free space to add the Replenisher data to 
{ 

count++; 
} 

RepPort[count] = sAgent.getReplenishersPort(); // Adds the new data to the arrays 
ReplPfcount] = sAgent.getReplenisherslP(); 

sAgent.SendOutServiceAgent(); // Passes the service agent onto the next module 
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public void processServicerslnfo(RepDetails rep, String IP, int port) 
{ 

DisplayError dError; 
AlertAgent agent; 

RepDetails details = new RepDetails(); 

details = rep; // A local copy of the class RepDetails, this stores all the Replenishers 
details 

int count =0; 
int counter =0; 
CurrentIP = IP; 
CurrentPort = port; 

String tempLocation = details.getLocation(); // Gets the Replenishers location 

String tempStatus = details.getStatus(); // Gets the Replenishers status 

String[] tempService = details.getServicesQ; // Gets the list of what the Replenisher can 



if (tempLocation.equalslgnoreCase(LookForLocation)) 
{ 

if (tempStatus. equalslgnoreCase(LookForStatus)) 
{ 

if (tempService[0].equalslgnoreCase("Dispenser")) 
{ 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH,this); 
} 

else if (tempService[1].equalslgnoreCase( n Card Reader")) 
{ 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH,this); 
} 

else if (tempService[2].equalslgnoreCase("Printer n )) 
{ 

dError = new DisplayError(ErrorlP, ErrorModule, ErrorSOH.this); 
} 

if (tempStatus.equalslgnoreCase("Primary")) 
LookForStatus = "Secondary"; 

if (tempStatus.equalslgnoreCase("Secondary")) 
LookForStatus = "Final"; 
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if (tempStatus.equalslgnoreCase("Final")) 
{ 

LookForStatus = "Primary"; 
if (tempLocation.equalsIgnoreCase("Local")) 
{ 

LookForLocation = "Remote"; 
} 

} 

NumberOfServicers++; 
} 

else 
{ 

int size = 0; 

while (IPList[size] != null) // Gets the number of Replenishers in the list 
{ 

size++; 
} 

if (NumberOfServicers == size) //When all the Replenishers have been visited, go 
back 

{ 

int nextport = PortList[0]; // Set to the starting port number 
String nextIP = IPList[0]; // Set to the starting IP number 
String signal = "Alert Agent"; 

Client client = new Client(nextlP, nextport, signal,this); // Send out the agent 
} 

else 
{ 

while (IPList[counter] != CurrentIP) // Find the array position of the Replenisher 
{ 

counter++; 
} 

if (IPList[counter].equalslgnoreCase(CurrentlP)) 
{ 

int nextport = Portl_ist[counter++]; // Move on to the next Replenisher if 
String nextIP = IPList[counter++]; // nothing suitable here 
String signal = "Alert Agent"; 

Client client = new Client(nextlP, nextport, signal,this); 
} 

} 

NumberOfServicers++; 
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If (temp.equalslgnoreCase("Shutter Jam")) 
{ 

Description[count] = "The shutter has jammed " + "open or closed. This " + 

" was detected when a card was" + "being accepted or ejected" 

Check[count] = "Shutter, Card Reader"; 
StateOfHealth = "INSPECT NOW"; 
} 
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public void runServer() 
{ 

int sPort = 6050; // initialises this value to 6050 
ServerSocket Serv; 



try 



{ 

// Set the socket to be monitored 
Serv = new ServerSocket(sPort); 
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// if the thread does not link to anything then create one and start it running 
if (runner == null) 
{ 

// run the ServerThread as a new thread 
runner = new AppletServer(Serv,this); 



} 



// start the thread runner running 

runner.start(); 

} 



catch (Exception e) 
{} 

} 



public void run() 

{ Object temp = null; FIG* 33 

String tempString = null; 

while (true) 
{ 

try 

{ 

// waits on the server until a message is received 
Socket server = Serv.accept(); 

// creates a new stream to connect to and bind 

ObjectlnputStream in = new ObjectlnputStream(server.getlnputStream()); 

// reads in the object and changes it too a String 
temp = in.readObject(); 
tempString = temp.toString(); 

if (tempString.equalslgnoreCase("Service Agent")) 
{ 

SAgentPresent = true; 

// Reads in the service agent 
sAgent= (ServiceAgent)in.readObject(); 
} 

} 

catch (Exception e) 
{ 

System.out.println(e); 
} 

• } 
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public void SendAgent() 
{ 

// Set Output To Send Agent To First Server 
try 

{ 

// try and connect to Socket destName.destPort 
Socket s = new Socket(destName, destPort); 

// create an ObjectOutputStream (out) 

ObjectOutputStream out = new ObjectOutputStream(s.getOutputStream()); 

// Got a connection Send Agent To Server 
// Sends out the corresponding agent 
if (state.equalslgnoreCase("Service Agent")) 
{ 

out.writeObject(state); 
out.writeObject(sAgent); 
} 

// Close outgoing port 
s.close(); 
out.closeO; 
} 

(Exception e) 
{ 
} 



catch 
} 
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1 Functional 
Block 


Class Name 


Description 


SoH 


AppletCenter.java 


Handles all the displaying and passing of data to the 
Applet. It controls what images etc. are displayed and 
when they are displayed. 




AppletMain.java 


Used to check that the thread is not already running 
and that the server can start running. Also used to 
pass data between the AppletCenter class and the 
AppletServer class. 




AppletServer.java 


Listens on a specified server connection and waits 
for incoming messages. It listens for messages from 
the Regional Server. Once a message has arrived it 
takes the corresponding actions. 




ControlPanel.java 


Holds navigation buttons and a Break button that is 

iiqpH nnl\/ for HpmnnQtrfltinn niirnococ 

UOCU Ul lly IVJI UCI J IUI loll CUIUI 1 |JUI|JUoCo. 




FrrnrQ FiypH iaun 
i ui o niAcu.jcivci 


Hi^nl^v/Q thp Fiy FrrnrQ crvopn anH all tho Hotailc 
L/iojJiayo u ic riA l_iiuio ouicci i cuiu an lilt; Uclaiio 

about an error. Any of the errors can be fixed by 
selecting one and pressing the OK button. This 
causes the ATM to reset itself and the error to be 
removed from the error records. 




FixMoney.java 


Help screen on how to fill the ATM with money. 




lnk.java 


Help screen on how to replace ribbon. 




Paper.java 


Help screen on how to fill the ATM with paper. 




Knife.java 


Help screen on how to replace the knife. 




PiirnoRin idva 
ruiycDii i.jdvct 


nt!i|j oiricmi uii i iuw iu tfiiifjiy uic |juiytf uni. 




Record.java 


Stores all the details about one error. An array of 
these is used to Dass error data between the various 
classes and store all current error information. 




ScreenO.java 


Displays the components of the main screen on the 
Applet. 




Screen Ljava 


Displays the components of the Replenishers screen 
on the Applet. 




Screen2.java 


Displays the components of the Field Engineers 
screen on the Applet. 
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Functional 
Block 


Class Name 


Description 


Regional 


Agent.java 


Class that is inherited by all the various agents. 




AlertAoent iava 


Anpnt that nrorliippH vuhpn an error nrri ire anrl 

takes this data to the Replenisher to ask for help. 




ConfirmMess.java 


Class that displays the whereabouts of the Applet. 




DisplayError.java 


Class that displays the components of the error and 
ask the Replenisher for help. 




ModuleDetails.java 


Stores the individual details of an ATM module. This 
information is vital in the movement of the agents 
around the network. 




MonitorAgent.java 


Agent that is used to constantly monitor the State of 
Health of all the ATM modules. It has also the 
intelligent to move around the network. 




MonitorClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. This class has 
the ability to send out all the different agents. 




MonitorServer.java 


Listens on a specified server connection and waits 
for incoming messages. It listens for Service Agents, 
Returning Monitor Agents and ATM modules 
registering. Once a message has arrived it takes the 
corresponding actions. 




SOH_Monitor.java 


Main class for this package. Used to handle all the 
incoming data and execute the calls that will send 
out the Monitor Agents. 




ObjectClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. It is responsible 
for sending requests to an ATM module Webserver. 
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Functional 
Block 


Class Name 


Description 


Regional - 
Cont'd 


ObjectServer.java 


Listens on a specified server connection and waits 
for incoming messages. Listens for messages and 
reset acknowledgements from the Embedded 
WebServers. Once a message has arrived it takes 

thp pnrrPQnnnriinn artinnQ 

LI wl 1 COUUI IIJ CIO llwl IO. 




ObjectMain.java 


Used to check that the thread is not already running 

£inrl that thp cpr\/pr pan Qtart ri mninn 
cu iu u icii u ic ocivci uai I olciil luiiiiniy. 




ServiceAgent.java 


Agent that will take the Replenishers Internet address 
and agent handler port number to the Regional 

fipn/pr ^nrl pII nf thp rpnictprpH ATM mnrtiiloc 

OCIVCI CM IU Clll U\ lilt/ I lOLtJl Ml 1 VI IllUUUItfO. 




StringProcessor.java 


Adds additional information to be sent out along with 

thp Prrnr Hata to thp Annlpt 
lilt; CilUl ucila IU lilt; AAfjpicU 




WaitAWhile.java 


This is a thread that is used to sleep if an ATM has 
not registered and a Replenisher has logged in. 




WebClient.java 


This class has the ability to bind to ports on certain 
terminals and send out data for them. Can send out 
serial data streams to the AppletServer. 




WebMain.java 


Used to check that the thread is not already running 
and that the server an start running. 




WebServer.java 


Listens on a specified server connection and waits 
for incoming messages. Listens for serial data 
coming from the AppletCenter. Once a message 
has arrived it takes the corresponding actions. 
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Functional 
Block 


Class Name 


Description 


Replenisher 


Clientjava 


This class has the ability to bind to ports on certain 
terminals and send out data for them. Sends out 
the Service Agent and the Alert Agents when 
desired. 




Server.java 


Listens on a specified server connection and waits 
for incoming messages. Listens for Alert Agents 
coming to check out the Replenishers details. 
Once a message has arrived it takes the 
corresponding actions. 




RepDetails.java 


Used to store the details a Replenisher has added 
to the details screen when they logged in. 




DetailsScreen.java 


Main class for this package. Used to take the 
information from the screen and store it in 
RepDetails. It will also start-up the server and call 
the Client class to send out the Service Agents. 
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Functional 
Block 


Class Name 


Description 


Agent 


AgentHandler.java 


Used to check that the thread is not already 
running and that the server an start running. 




AgentServer.java 


Listens on a specified server connection and 
waits for incoming messages. Listens for 
incoming Service and Monitor Agents. Once a 
message has arrived it takes the corresponding 
actions. 




AgentClient.java 


This class has the ability to bind to ports on 
certain terminals and send out data for them. 
Sends out Alert and Monitor Agents. 
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Functional 
Block 


Class Name 


Description 


Webserver 


Client.java 


This class has the ability to bind to ports on 
certain terminals and send out data for them. 
Sends out all the data that is required to display 
information on the Applet. 




Serve r.java 


Listens on a specified server connection and 
waits for incoming messages. Listens for 
requests from the Applet that are passed on 
by the Regional Server. Once a message has 
arrived n iaKes we corresponaing actions. 




WebServer.java 


Main class for this package, used to set-up and 
start the server. 




ErrorList.java 


Class that holds the array of errors that have 
been produced and location details about were 
the errors occurred. 




ResetDetails.java 


Class used to reset details in order to set a tally 
back to zero. 
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Functional 
Block 


Class Name 


Description 


Tallies 


Tallys.java 


Inherited by all the classes below. Used in the 
Regional Server to access their functions and get 
the necessary information. 




CardTallys.java 


Holds the tally mnemonics that are unique to the 
Card Reader class and the procedures that are 
needed to process them. 




DispenserTallys.java 


Holds the tally mnemonics that are unique to 
the Cash Dispenser class and the procedures 
that are needed to process them. 




PrinterTallys.java 


Holds the tally mnemonics that are unique to the 
Receipt Printer class and the procedures that 
are needed to process them. 




ProcesslPs.java 


Used to get the modules Internet address and 
process it. 
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